home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / unz520d2.zip / unzip.doc < prev    next >
Text File  |  1996-04-29  |  37KB  |  749 lines
  1.  
  2. UNZIP(1L)         MISC. REFERENCE MANUAL PAGES          UNZIP(1L)
  3.  
  4. NAME
  5.      unzip - list, test and extract compressed  files  in  a  ZIP
  6.      archive
  7.  
  8. SYNOPSIS
  9.      unzip     [-Z]     [-cflptuvz[abjnoqsCLMVX$]]     file[.zip]
  10.      [file(s) ...] [-x xfile(s) ...] [-d exdir]
  11.  
  12. DESCRIPTION
  13.      unzip will list, test, or extract files from a ZIP  archive,
  14.      commonly  found  on  MS-DOS  systems.   The default behavior
  15.      (with no options) is to extract into the  current  directory
  16.      (and  subdirectories  below it) all files from the specified
  17.      ZIP archive.  A  companion  program,  zip(1L),  creates  ZIP
  18.      archives; both programs are compatible with archives created
  19.      by PKWARE's PKZIP and PKUNZIP for MS-DOS, but in many  cases
  20.      the program options or default behaviors differ.
  21.  
  22. ARGUMENTS
  23.      file[.zip]
  24.           Path of the ZIP archive(s).  If the file  specification
  25.           is  a  wildcard,  each matching file is processed in an
  26.           order determined by the operating system (or file  sys-
  27.           tem).   Only  the  filename can be a wildcard; the path
  28.           itself cannot.  Wildcard  expressions  are  similar  to
  29.           Unix egrep(1) (regular) expressions and may contain:
  30.  
  31.           *    matches a sequence of 0 or more characters
  32.  
  33.           ?    matches exactly 1 character
  34.  
  35.           [...]
  36.                matches any  single  character  found  inside  the
  37.                brackets;  ranges  are  specified  by  a beginning
  38.                character, a hyphen, and an ending character.   If
  39.                an  exclamation point or a caret (`!' or `^') fol-
  40.                lows the left bracket, then the range  of  charac-
  41.                ters within the brackets is complemented (that is,
  42.                anything except the characters inside the brackets
  43.                is considered a match).
  44.  
  45.           (Be sure to quote any character that might otherwise be
  46.           interpreted  or  modified by the operating system, par-
  47.           ticularly under Unix  and  VMS.)   If  no  matches  are
  48.           found,  the  specification  is  assumed to be a literal
  49.           filename; and if that also fails, the  suffix  .zip  is
  50.           appended.  Note that self-extracting ZIP files are sup-
  51.           ported, as with any other ZIP archive; just specify the
  52.           .exe suffix (if any) explicitly.
  53.  
  54.      [file(s)]
  55.           An optional list of archive members  to  be  processed,
  56.  
  57. Info-ZIP          Last change: 30 Apr 96 (v5.2)                 1
  58.  
  59. UNZIP(1L)         MISC. REFERENCE MANUAL PAGES          UNZIP(1L)
  60.  
  61.           separated  by  spaces.   (VMS  versions  compiled  with
  62.           VMSCLI defined must delimit files with commas  instead.
  63.           See  -v  in  OPTIONS below.) Regular expressions (wild-
  64.           cards) may be  used  to  match  multiple  members;  see
  65.           above.   Again, be sure to quote expressions that would
  66.           otherwise be expanded or modified by the operating sys-
  67.           tem.
  68.  
  69.      [-x xfile(s)]
  70.           An optional list of archive members to be excluded from
  71.           processing.   Since wildcard characters match directory
  72.           separators (`/'), this option may be  used  to  exclude
  73.           any  files  that  are  in subdirectories.  For example,
  74.           ``unzip foo *.[ch] -x */*'' would extract all C  source
  75.           files  in the main directory, but none in any subdirec-
  76.           tories.  Without the -x option, all C source  files  in
  77.           all directories within the zipfile would be extracted.
  78.  
  79.      [-d exdir]
  80.           An optional directory to which to  extract  files.   By
  81.           default,  all files and subdirectories are recreated in
  82.           the current directory; the -d option allows  extraction
  83.           in an arbitrary directory (always assuming one has per-
  84.           mission to write to the directory).  This  option  need
  85.           not  appear  at the end of the command line; it is also
  86.           accepted before the  zipfile  specification  (with  the
  87.           normal options), immediately after the zipfile specifi-
  88.           cation, or between the file(s) and the -x option.   The
  89.           option  and  directory  may be concatenated without any
  90.           white space between them, but note that this may  cause
  91.           normal shell behavior to be suppressed.  In particular,
  92.           ``-d ~'' (tilde) is expanded by Unix C shells into  the
  93.           name  of  the  user's  home  directory,  but ``-d~'' is
  94.           treated as a literal subdirectory ``~'' of the  current
  95.           directory.
  96.  
  97. OPTIONS
  98.      Note that, in order to support obsolescent hardware, unzip's
  99.      usage  screen is limited to 22 or 23 lines and should there-
  100.      fore be considered only a reminder of the basic unzip syntax
  101.      rather than an exhaustive list of all possible flags.
  102.  
  103.      -Z   zipinfo(1L) mode.  If the first option on  the  command
  104.           line  is  -Z,  the  remaining  options  are taken to be
  105.           zipinfo(1L) options.  See the appropriate  manual  page
  106.           for a description of these options.
  107.  
  108.      -c   extract files to stdout/screen (``CRT'').  This  option
  109.           is  similar  to  the  -p option except that the name of
  110.           each file is printed as it is extracted, the -a  option
  111.           is  allowed,  and  ASCII-EBCDIC conversion is automati-
  112.           cally performed if appropriate.   This  option  is  not
  113.  
  114. Info-ZIP          Last change: 30 Apr 96 (v5.2)                 2
  115.  
  116. UNZIP(1L)         MISC. REFERENCE MANUAL PAGES          UNZIP(1L)
  117.  
  118.           listed in the unzip usage screen.
  119.  
  120.      -f   freshen existing files, i.e., extract only those  files
  121.           that  already exist on disk and that are newer than the
  122.           disk copies.  By default unzip queries before overwrit-
  123.           ing,  but  the  -o  option  may be used to suppress the
  124.           queries.  Note that under many operating  systems,  the
  125.           TZ   (timezone)   environment   variable  must  be  set
  126.           correctly in order for  -f  and  -u  to  work  properly
  127.           (under Unix the variable is usually set automatically).
  128.           The reasons for this are somewhat subtle but have to do
  129.           with  the  differences  between  DOS-format  file times
  130.           (always local time) and Unix-format  times  (always  in
  131.           GMT)  and  the necessity to compare the two.  A typical
  132.           TZ value is ``PST8PDT'' (US Pacific time with automatic
  133.           adjustment   for  Daylight  Savings  Time  or  ``summer
  134.           time'').
  135.  
  136.      -l   list  archive  files  (short   format).    The   names,
  137.           uncompressed  file  sizes  and  modification  dates and
  138.           times of the specified files are  printed,  along  with
  139.           totals  for all files specified.  If UnZip was compiled
  140.           with OS2_EAS defined, the -l option also lists  columns
  141.           for  the sizes of stored OS/2 extended attributes (EAs)
  142.           and OS/2 access control lists (ACLs).  In addition, the
  143.           zipfile  comment  and individual file comments (if any)
  144.           are displayed.  If a file was archived from  a  single-
  145.           case  file system (for example, the old MS-DOS FAT file
  146.           system) and the -L option was given,  the  filename  is
  147.           converted  to  lowercase  and  is prefixed with a caret
  148.           (^).
  149.  
  150.      -p   extract files to pipe (stdout).  Nothing but  the  file
  151.           data  is  sent  to  stdout,  and  the  files are always
  152.           extracted in binary format, just as they are stored (no
  153.           conversions).
  154.  
  155.      -t   test archive files.  This option extracts  each  speci-
  156.           fied file in memory and compares the CRC (cyclic redun-
  157.           dancy check, an enhanced checksum) of the expanded file
  158.           with the original file's stored CRC value.
  159.  
  160.      -u   update existing files and create new  ones  if  needed.
  161.           This  option  performs  the  same  function  as  the -f
  162.           option, extracting (with query) files  that  are  newer
  163.           than  those with t